Comments for PR-MathML2-20010108

Here are comments on the MathML 2.0 Proposed Recommendation [1].
I used a better spell checking method and found more typos
(a few of which are holdovers from the Candidate Recommendation).
Please use these suggestions, or not, as you see fit.

Two small structural changes are needed. First, a conformance chapter
should be evident from the front table of contents. I would break
out the relevant parts of section 7.2.1 into a separate page
called "Conformance." Second, Appendix K needs a normative section.

Especially to help the conformance chapter, and also to be clear,
you could make RFC 2119 a normative reference and quote this part:
       The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL
       NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED",  "MAY", and
       "OPTIONAL" in this document are to be interpreted as described in
       RFC 2119.
Please see RFC 2119 at http://www.ietf.org/rfc/rfc2119.txt. If you don't
wish to use this RFC, then these words need definitions. If you don't
like the RFC-style caps, then here is an alternate idea:
<p>The key words <strong>must,</strong> <strong>must not</strong>,
<strong>required</strong>, <strong>shall</strong>, <strong>shall
not</strong>, <strong>should</strong>, <strong>should not</strong>,
<strong>recommended</strong>, <strong>may</strong>, and
<strong>optional</strong> in this document are to be interpreted as
described in [<a href="appendixk.html#RFC2119">RFC2119</a>].</p>

Globally, "whitespace" is two words, "white space"
(see http://www.w3.org/TR/REC-xml#sec-white-space).

Also globally, "braces" are "curly brackets," and "blanks" are "spaces"
(see http://www.unicode.org/charts/PDF/U0000.pdf).

3.2.5.2 par. after table is repeated, for the most part, in 3.3.4.2
(mstyle). All six paragraphs of 3.2.2.2 Color-related attributes are
repeated in 3.3.4.2 except the mention of mathcolor. They should only
appear in one place.

 From here on a section number is followed by a quote and a suggestion.

2.3.1 par. 3
code point for under consideration
code point under consideration

2.4.4.1 second par. after table
dicussion
discussion

2.4.4.1 third par. after table needs ending period.

2.4.4.3 par. 2
stylesheets
style sheets

3.2.1.1 par. 2 and 3, and 3.2.2 pars. 6 and 7
Is "Math Alphabet" a proper noun?
http://www.unicode.org/unicode/alloc/Pipeline.html and 
http://www.egt.ie/standards/iso10646/plane1-roadmap-table.html
say "Mathematical Alphanumeric Symbols." From here on, I adopt
that.

3.2.1.1 par. 3
in Section 6.2.3 [Mathematical Alphabetic Symbol Characters.].
in Section 6.2.3 [Mathematical Alphanumeric Symbols].

3.2.2 par. 5
renderers have a complete freedom
renderers have complete freedom

3.2.2 third to last par.
Tokens elements
Token elements

3.2.2.1 par. 2
Math Alphabetic character
Mathematical Alphanumeric Symbol

3.2.2.2 par. 1
depreciated color
deprecated color

3.2.3.2 last par.
Math Alphabet characters
Mathematical Alphanumeric Symbols

[Mathematical Alphabetic Symbol Characters.]
[Mathematical Alphanumeric Symbols]

3.2.5.1 par. 1
braces
curly brackets

3.2.6.4 par. 2
in the sum (see Section 3.2.3 [Identifier (mi)], mi).
in the sum; (see Section 3.2.3 [Identifier (mi)]).

3.5.5.10 par. 1
a MathML applications
a MathML application

3.6.1.1 par. 2
"described in Section 7.2.2 [Handling of Errors] on the treatment
of MathML errors." can be cut to "described in Section 7.2.2
[Handling of Errors]."

4.2.3.2 int
If both lowlimit and uplimit schema
If both lowlimit and uplimit schemata [or schemas]

conjuction
conjunction

4.3.2.8
ionored
ignored

4.4.2.8 par. 4
is a the object
is the object

4.4.2.16 par. 3
to ba taken
to be taken

4.4.3.6 par. 3
arithemtic
arithmetic

4.4.3.18
conjuction
conjunction

4.4.5.3 par. 4
contaioning
containing

4.4.5.11
laplacian
[could be capitalized if Cartesian is]
Laplacian

4.4.5.3 par. 5
differentation
differentiation

4.4.12.5
[Discussion is repeated under an extra "Example" heading.]

5.1 par. 6
style-sheet
style sheet

5.2.1 par. 4
somtimes
sometimes

5.3.3 par. 1
accomodate
accommodate

5.4.3 par. 2
frought
fraught

5.4.3 last par.
style-sheet
style sheet

6. TOC and heading
6.2.3 Mathematical Alphabetic Symbol Characters. [note ending period 
needs cutting too]
6.2.3 Mathematical Alphanumeric Symbols

6. TOC and heading (and thus all links), and 6.2.3 par. 2 (twice) and 
par. 3 and last par.
6.3.6 Mathematical Alphabetic Characters
6.3.6 Mathematical Alphanumeric Symbols

["Mathematical Alphanumeric Symbols" in 6.4.4 list item 2 looks right.]

6. MathML Specification
MathML specification

6.2.1 list item 2
Numeric
numeric

6.2.1 list item 3
well formed
well-formed

6.2.3 par. 2
expected Unicode 3.1
expected in Unicode 3.1

Supplemental Multilingual Plane
Secondary Multilingual Plane

6.2.3 last par.
acessibility
accessibility

6.3 par. 1
Universal Character Set (UCS)
UCS [It was expanded in 6.1 par. 4.]

evolve Section 6.4.4
evolve, see Section 6.4.4

the Home Page of the W3C Math WG should be consulted
(can link again)
the W3C Math Working Group home page should be consulted

6.3.2 par. 1
Mathematics
mathematics

6.3.3, status in Key for 000.html through 1D7.html
not given a MathMl name
not given a MathML name

6.4.4 par. 1
UCS (Universal Character Set)
UCS [Twice. It was expanded in 6.1 par. 4.]

6.4.4 first list item
[Unicode 3.0] and [ISO/IEC 10646-1:2000] need links
to Appendix K, and the last one needs a reference.

6.4.4 last list item
in September
in September 2000 [?]

7. last par.
working group [twice]
Working Group

7.1.3 par. 4 can be revised and link to [RFC3023] and
http://www.ietf.org/rfc/rfc3023.txt can be added in Appendix K
(as I imagine you are aware).

8.1.2.2 par. 1
usefullness
usefulness

C.1 par. 1
(An index to the definitions is provided later in this document.)
[Where? Could you link to it here?]

C.1.2 signature
square braces
square brackets

C.1.2 function
nary
n-ary

C.2
The Description of MMLdefinitions in C.2.x all say "See also . [?]

C.2.2.9 par. 2
itsself
itself

C.2.3.7
itsself
itself

C.2.3.22
(compex)->real
(complex)->real

C.2.4.8 par. 1
quantites
quantities

C.2.5.6 par. 1
quantifiy
quantify

C.2.5.8 par. 3
implicitely
implicitly

C.2.5.10 par. 3
respectivly
respectively

C.2.8.1 through C.2.8.27 and C.2.11.14
     as described in Abramowitz and Stegun, section xx
These need to be links, maybe "see [A&S] section xx", to a
normative reference in a new "Normative" section of Appendix K.
     Abramowitz, Milton, Irene A. Stegun (editors), Handbook of
     Mathematical Fuctions: With Formulas, Graphs, and Mathmetical
     Tables, Dover Publications Inc., December 1977, ISBN: 0-486-61272-4

C.2.9.1 through C.2.10.7
     See CRC Standard Mathematical Tables and Formulae, editor: Dan
     Zwillinger, CRC Press Inc., 1996, section xx
Same here, need to be links, maybe "see [Zwillinger] section xx",
to a normative reference in Appendix K.
     Daniel Zwillinger (editor), Standard Mathematical Tables and
     Formulae, CRC Press LLC, January 1996, ISBN: 0-849-32479-3

C.2.9.6 par. 1 and C.2.10.6 par. 1 (three times)
ith
i'th [or use ith globally]

D.1.2 MathMLContainer and D.1.3.3 MathMLPresentationContainer
arbitarily
arbitrarily

D.1.3.4 MathMLMultiScriptsElement setSubScriptAt return value
chlid
child

G.
Rules desling with
Rules dealing with

H. Cascading Style Sheets (CSS)
A mechanism that allows
A language that allows

H. MIME
multi-media
multimedia

I.
Dave Raggett, W3C (Hewlett Packard), Bristol, UK [twice]
Dave Raggett, W3C (Openwave) [I don't know his city.]
[If you wish to make historical reference to HP, it is
hyphenated, Hewlett-Packard.]

I.2
The working group
The Working Group

K.
DOM Level 2 Core is now a Recommendation, with different editors.
XLink is now a Proposed Recommendation, with different editors.
XPointer is now a Working Draft.
Unicode can link to http://www.unicode.org/unicode/standard/standard.html.
Also, several references need punctuation between the editor or author's
name and the title, and again between the title and publisher.

[1] http://www.w3.org/TR/2001/PR-MathML2-20010108/

Best wishes for your project,

-- 
Susan Lesch - mailto:lesch@w3.org  tel:+1.858.483.4819
World Wide Web Consortium (W3C) - http://www.w3.org/

Received on Sunday, 28 January 2001 05:02:03 UTC